<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>hsm-statechart: hsm/hsm_context.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td id="projectlogo"><img alt="Logo" src="hsm-statechart.png"/></td>
  <td style="padding-left: 0.5em;">
   <div id="projectname">hsm-statechart
   &#160;<span id="projectnumber">0.5</span>
   </div>
   <div id="projectbrief">An easy to use hierarchical state machine for C and C++</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('hsm__context_8c.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Macros</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark">&#160;</span>Pages</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="headertitle">
<div class="title">hsm_context.c</div>  </div>
</div><!--header-->
<div class="contents">
<a href="hsm__context_8c.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno">    1</span>&#160;</div>
<div class="line"><a name="l00010"></a><span class="lineno">   10</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="hsm__context_8h.html" title="Support for optional per-state instance data.">hsm_context.h</a>&quot;</span></div>
<div class="line"><a name="l00011"></a><span class="lineno">   11</span>&#160;<span class="preprocessor">#include &quot;<a class="code" href="hsm__stack_8h.html" title="Internal stack manipulation routines used by hsm_machine for managing per state instance data...">hsm_stack.h</a>&quot;</span></div>
<div class="line"><a name="l00012"></a><span class="lineno">   12</span>&#160;<span class="preprocessor">#include &lt;assert.h&gt;</span></div>
<div class="line"><a name="l00013"></a><span class="lineno">   13</span>&#160;<span class="preprocessor">#include &lt;stddef.h&gt;</span></div>
<div class="line"><a name="l00014"></a><span class="lineno">   14</span>&#160;<span class="preprocessor">#include &lt;string.h&gt;</span></div>
<div class="line"><a name="l00015"></a><span class="lineno">   15</span>&#160;<span class="preprocessor">#include &lt;malloc.h&gt;</span></div>
<div class="line"><a name="l00016"></a><span class="lineno">   16</span>&#160;</div>
<div class="line"><a name="l00017"></a><span class="lineno">   17</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00018"></a><span class="lineno">   18</span>&#160;<span class="comment">// HsmContext</span></div>
<div class="line"><a name="l00019"></a><span class="lineno">   19</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00020"></a><span class="lineno">   20</span>&#160;<span class="keyword">static</span> <span class="keywordtype">void</span> HsmContextFree( <a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context_t</a>* ctx )</div>
<div class="line"><a name="l00021"></a><span class="lineno">   21</span>&#160;{</div>
<div class="line"><a name="l00022"></a><span class="lineno">   22</span>&#160;    free(ctx);</div>
<div class="line"><a name="l00023"></a><span class="lineno">   23</span>&#160;}</div>
<div class="line"><a name="l00024"></a><span class="lineno">   24</span>&#160;</div>
<div class="line"><a name="l00025"></a><span class="lineno">   25</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00026"></a><span class="lineno"><a class="code" href="hsm__context_8h.html#a37882939881b43db4f51a7cc24544f11">   26</a></span>&#160;<a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context</a> <a class="code" href="hsm__context_8c.html#a37882939881b43db4f51a7cc24544f11" title="Helper to create a new context object.">HsmContextAlloc</a>( <span class="keywordtype">size_t</span> size )</div>
<div class="line"><a name="l00027"></a><span class="lineno">   27</span>&#160;{</div>
<div class="line"><a name="l00028"></a><span class="lineno">   28</span>&#160;    <a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context_t</a> * ctx= calloc( 1, size );</div>
<div class="line"><a name="l00029"></a><span class="lineno">   29</span>&#160;    <span class="keywordflow">if</span> (ctx) {</div>
<div class="line"><a name="l00030"></a><span class="lineno">   30</span>&#160;        <span class="comment">// doesn&#39;t point to free directly to work better with msdev&#39;s crtdebug macros</span></div>
<div class="line"><a name="l00031"></a><span class="lineno">   31</span>&#160;        ctx-&gt;<a class="code" href="hsm__context_8h.html#ad0208ce8f889006d0c5f3d92c030dd2b" title="per context callback">popped</a>= HsmContextFree;</div>
<div class="line"><a name="l00032"></a><span class="lineno">   32</span>&#160;    }        </div>
<div class="line"><a name="l00033"></a><span class="lineno">   33</span>&#160;    <span class="keywordflow">return</span> ctx;</div>
<div class="line"><a name="l00034"></a><span class="lineno">   34</span>&#160;}</div>
<div class="line"><a name="l00035"></a><span class="lineno">   35</span>&#160;</div>
<div class="line"><a name="l00036"></a><span class="lineno">   36</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00037"></a><span class="lineno">   37</span>&#160;<span class="comment">// HsmContextStack</span></div>
<div class="line"><a name="l00038"></a><span class="lineno">   38</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00039"></a><span class="lineno"><a class="code" href="hsm__context_8h.html#ab3a13b1fa2faea3f79edb11b10217a1a">   39</a></span>&#160;<a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack</a> <a class="code" href="hsm__context_8c.html#a6b9a76b7bb8ad4de9d5140789809f9c3" title="Resets the hsm_context_stack structure.">HsmContextStack</a>( <a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack_t</a>* stack, <a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context</a> ctx )</div>
<div class="line"><a name="l00040"></a><span class="lineno">   40</span>&#160;{</div>
<div class="line"><a name="l00041"></a><span class="lineno">   41</span>&#160;    <span class="keywordflow">if</span>(stack) {</div>
<div class="line"><a name="l00042"></a><span class="lineno">   42</span>&#160;        memset(stack, 0, <span class="keyword">sizeof</span>(<a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack_t</a>));</div>
<div class="line"><a name="l00043"></a><span class="lineno">   43</span>&#160;        stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a>= ctx;</div>
<div class="line"><a name="l00044"></a><span class="lineno">   44</span>&#160;    }        </div>
<div class="line"><a name="l00045"></a><span class="lineno">   45</span>&#160;    <span class="keywordflow">return</span> stack;</div>
<div class="line"><a name="l00046"></a><span class="lineno">   46</span>&#160;}</div>
<div class="line"><a name="l00047"></a><span class="lineno">   47</span>&#160;</div>
<div class="line"><a name="l00048"></a><span class="lineno">   48</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"><a class="code" href="hsm__stack_8h.html#a4ea4539c5534390f7885ae78bcf40019">   49</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="hsm__context_8c.html#ae38c05493a767abe0262890262492a99" title="Add a new context to the stack.">HsmContextPush</a>( <a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack</a> stack, <a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context</a> ctx )</div>
<div class="line"><a name="l00050"></a><span class="lineno">   50</span>&#160;{</div>
<div class="line"><a name="l00051"></a><span class="lineno">   51</span>&#160;    <span class="keywordflow">if</span> (stack) {</div>
<div class="line"><a name="l00052"></a><span class="lineno">   52</span>&#160;        <span class="comment">// invalid to push NULL once valid data exists</span></div>
<div class="line"><a name="l00053"></a><span class="lineno">   53</span>&#160;        <a class="code" href="hsm__types_8h.html#ae90abec415767fe632682dddda6e1567" title="maps to an assert in debug builds compiles out in non-debug builds">HSM_ASSERT</a>( !stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a> || ctx ); </div>
<div class="line"><a name="l00054"></a><span class="lineno">   54</span>&#160;        <span class="keywordflow">if</span> (ctx &amp;&amp; (stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a> != ctx)) {</div>
<div class="line"><a name="l00055"></a><span class="lineno">   55</span>&#160;            ctx-&gt;parent    = stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a>;</div>
<div class="line"><a name="l00056"></a><span class="lineno">   56</span>&#160;            stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a> = ctx;</div>
<div class="line"><a name="l00057"></a><span class="lineno">   57</span>&#160;            stack-&gt;<a class="code" href="hsm__context_8h.html#a1483325021805936ca81887f962c621d" title="bit flags for whether a push added unique data">presence</a> |= ( 1&lt;&lt; stack-&gt;<a class="code" href="hsm__context_8h.html#a1e97dda6f0163b4a8b24d430ed603b93" title="total number of pushes that have occured ( always &gt;= the depth of the statemachine&#39;s deepest state )...">count</a> );</div>
<div class="line"><a name="l00058"></a><span class="lineno">   58</span>&#160;        }</div>
<div class="line"><a name="l00059"></a><span class="lineno">   59</span>&#160;        <span class="comment">// regardless alway update the count</span></div>
<div class="line"><a name="l00060"></a><span class="lineno">   60</span>&#160;        <span class="comment">// the presence bits start at zero, so presence[count] by default ==0</span></div>
<div class="line"><a name="l00061"></a><span class="lineno">   61</span>&#160;        ++stack-&gt;<a class="code" href="hsm__context_8h.html#a1e97dda6f0163b4a8b24d430ed603b93" title="total number of pushes that have occured ( always &gt;= the depth of the statemachine&#39;s deepest state )...">count</a>;</div>
<div class="line"><a name="l00062"></a><span class="lineno">   62</span>&#160;    }</div>
<div class="line"><a name="l00063"></a><span class="lineno">   63</span>&#160;}</div>
<div class="line"><a name="l00064"></a><span class="lineno">   64</span>&#160;</div>
<div class="line"><a name="l00065"></a><span class="lineno">   65</span>&#160;<span class="comment">// ---------------------------------------------------------------</span></div>
<div class="line"><a name="l00066"></a><span class="lineno"><a class="code" href="hsm__stack_8h.html#aee4fad29d8526e04c590847a69e9ed50">   66</a></span>&#160;<a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context</a> <a class="code" href="hsm__context_8c.html#aee4fad29d8526e04c590847a69e9ed50" title="Remove the most recently added context.">HsmContextPop</a>( <a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack</a> stack )</div>
<div class="line"><a name="l00067"></a><span class="lineno">   67</span>&#160;{</div>
<div class="line"><a name="l00068"></a><span class="lineno">   68</span>&#160;    <a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context</a> bye= NULL;</div>
<div class="line"><a name="l00069"></a><span class="lineno">   69</span>&#160;    <span class="keywordflow">if</span> (stack &amp;&amp; stack-&gt;<a class="code" href="hsm__context_8h.html#a1e97dda6f0163b4a8b24d430ed603b93" title="total number of pushes that have occured ( always &gt;= the depth of the statemachine&#39;s deepest state )...">count</a> &gt; 0) {</div>
<div class="line"><a name="l00070"></a><span class="lineno">   70</span>&#160;        <span class="comment">// get the presence tester</span></div>
<div class="line"><a name="l00071"></a><span class="lineno">   71</span>&#160;        <a class="code" href="hsm__types_8h.html#a5041728bd5890050e49ba4506a83f86f" title="32 bit unsigned integer">hsm_uint32</a> bit= (1 &lt;&lt; --stack-&gt;<a class="code" href="hsm__context_8h.html#a1e97dda6f0163b4a8b24d430ed603b93" title="total number of pushes that have occured ( always &gt;= the depth of the statemachine&#39;s deepest state )...">count</a>);</div>
<div class="line"><a name="l00072"></a><span class="lineno">   72</span>&#160;        <span class="comment">// was that a unique piece of data in that spot</span></div>
<div class="line"><a name="l00073"></a><span class="lineno">   73</span>&#160;        <span class="keywordflow">if</span> ((stack-&gt;<a class="code" href="hsm__context_8h.html#a1483325021805936ca81887f962c621d" title="bit flags for whether a push added unique data">presence</a> &amp; bit) !=0) {</div>
<div class="line"><a name="l00074"></a><span class="lineno">   74</span>&#160;            <span class="comment">// clear that bit</span></div>
<div class="line"><a name="l00075"></a><span class="lineno">   75</span>&#160;            stack-&gt;<a class="code" href="hsm__context_8h.html#a1483325021805936ca81887f962c621d" title="bit flags for whether a push added unique data">presence</a> &amp;= ~bit;</div>
<div class="line"><a name="l00076"></a><span class="lineno">   76</span>&#160;            <span class="comment">// get the most recent thing pushed</span></div>
<div class="line"><a name="l00077"></a><span class="lineno">   77</span>&#160;            bye= stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a>;</div>
<div class="line"><a name="l00078"></a><span class="lineno">   78</span>&#160;            <span class="comment">// and remove it </span></div>
<div class="line"><a name="l00079"></a><span class="lineno">   79</span>&#160;            <span class="keywordflow">if</span> (bye) {</div>
<div class="line"><a name="l00080"></a><span class="lineno">   80</span>&#160;                stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a>= bye-&gt;parent;</div>
<div class="line"><a name="l00081"></a><span class="lineno">   81</span>&#160;            }                </div>
<div class="line"><a name="l00082"></a><span class="lineno">   82</span>&#160;        }</div>
<div class="line"><a name="l00083"></a><span class="lineno">   83</span>&#160;    }</div>
<div class="line"><a name="l00084"></a><span class="lineno">   84</span>&#160;    <span class="keywordflow">return</span> bye;</div>
<div class="line"><a name="l00085"></a><span class="lineno">   85</span>&#160;}</div>
<div class="line"><a name="l00086"></a><span class="lineno">   86</span>&#160;</div>
<div class="line"><a name="l00087"></a><span class="lineno">   87</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00088"></a><span class="lineno">   88</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00089"></a><span class="lineno">   89</span>&#160;<span class="comment">//---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00090"></a><span class="lineno"><a class="code" href="hsm__stack_8h.html#a8204ed8010ccfdddbc715ade452c99a4">   90</a></span>&#160;<span class="keywordtype">void</span> <a class="code" href="hsm__context_8c.html#a92505c79691b3926022a74c9657c12bd" title="Initialize the iterator to the most recent state&#39;s context.">HsmContextIterator</a>( <a class="code" href="hsm__stack_8h.html#structhsm__context__iterator__rec" title="Structure to traverse a context stack.">hsm_context_iterator_t</a>* it, <a class="code" href="hsm__context_8h.html#structhsm__context__stack__rec" title="Per state machine instance manager of context data.">hsm_context_stack</a> stack )</div>
<div class="line"><a name="l00091"></a><span class="lineno">   91</span>&#160;{</div>
<div class="line"><a name="l00092"></a><span class="lineno">   92</span>&#160;    <a class="code" href="hsm__types_8h.html#ae90abec415767fe632682dddda6e1567" title="maps to an assert in debug builds compiles out in non-debug builds">HSM_ASSERT</a>( it );</div>
<div class="line"><a name="l00093"></a><span class="lineno">   93</span>&#160;    <span class="keywordflow">if</span> (it) {</div>
<div class="line"><a name="l00094"></a><span class="lineno">   94</span>&#160;        <span class="keywordflow">if</span> (!stack) {</div>
<div class="line"><a name="l00095"></a><span class="lineno">   95</span>&#160;            memset( it, 0, <span class="keyword">sizeof</span>(<a class="code" href="hsm__stack_8h.html#structhsm__context__iterator__rec" title="Structure to traverse a context stack.">hsm_context_iterator_t</a>));</div>
<div class="line"><a name="l00096"></a><span class="lineno">   96</span>&#160;        }</div>
<div class="line"><a name="l00097"></a><span class="lineno">   97</span>&#160;        <span class="keywordflow">else</span> {</div>
<div class="line"><a name="l00098"></a><span class="lineno">   98</span>&#160;            it-&gt;<a class="code" href="hsm__stack_8h.html#aeb87bb150bdcab632f4cd300c8dff869" title="pointer the the machine&#39;s stack">stack</a>= stack;</div>
<div class="line"><a name="l00099"></a><span class="lineno">   99</span>&#160;            it-&gt;<a class="code" href="hsm__stack_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="pointer to the current unique context data">context</a> = stack-&gt;<a class="code" href="hsm__context_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="most recently added unique context pointer">context</a>;</div>
<div class="line"><a name="l00100"></a><span class="lineno">  100</span>&#160;            it-&gt;<a class="code" href="hsm__stack_8h.html#a468c9247400777eda1b6feb5d578a353" title="index of depth into the stack">sparse_index</a>= stack-&gt;<a class="code" href="hsm__context_8h.html#a1e97dda6f0163b4a8b24d430ed603b93" title="total number of pushes that have occured ( always &gt;= the depth of the statemachine&#39;s deepest state )...">count</a>; <span class="comment">// start at *back* ( newest pushed )</span></div>
<div class="line"><a name="l00101"></a><span class="lineno">  101</span>&#160;        }</div>
<div class="line"><a name="l00102"></a><span class="lineno">  102</span>&#160;    }</div>
<div class="line"><a name="l00103"></a><span class="lineno">  103</span>&#160;}</div>
<div class="line"><a name="l00104"></a><span class="lineno">  104</span>&#160;</div>
<div class="line"><a name="l00105"></a><span class="lineno">  105</span>&#160;<span class="comment">/* ---------------------------------------------------------------------------</span></div>
<div class="line"><a name="l00106"></a><span class="lineno">  106</span>&#160;<span class="comment">   a bit in the 0th column: topmost returned a value different than the machine&#39;s outer context</span></div>
<div class="line"><a name="l00107"></a><span class="lineno">  107</span>&#160;<span class="comment">   a bit in the 1st column: child of topmost returned a value different than its parent</span></div>
<div class="line"><a name="l00108"></a><span class="lineno">  108</span>&#160;<span class="comment">   and so on.</span></div>
<div class="line"><a name="l00109"></a><span class="lineno">  109</span>&#160;<span class="comment"></span></div>
<div class="line"><a name="l00110"></a><span class="lineno">  110</span>&#160;<span class="comment">   |..|...|.. &lt;- sparse stack:</span></div>
<div class="line"><a name="l00111"></a><span class="lineno">  111</span>&#160;<span class="comment">   0123456789 &lt;- 9 states deep in the presence; _top=9</span></div>
<div class="line"><a name="l00112"></a><span class="lineno">  112</span>&#160;<span class="comment">   0  1   2   &lt;- 3 contexts in the store; _store.size()=3</span></div>
<div class="line"><a name="l00113"></a><span class="lineno">  113</span>&#160;<span class="comment">   to traverse the stack you start with _it=9, and the location of the last context</span></div>
<div class="line"><a name="l00114"></a><span class="lineno">  114</span>&#160;<span class="comment">   whenever you cross a new set bit, you move the context location.</span></div>
<div class="line"><a name="l00115"></a><span class="lineno">  115</span>&#160;<span class="comment">   an iterator across a series of bits also needs the source bits.</span></div>
<div class="line"><a name="l00116"></a><span class="lineno">  116</span>&#160;<span class="comment"> * --------------------------------------------------------------------------- */</span> </div>
<div class="line"><a name="l00117"></a><span class="lineno"><a class="code" href="hsm__stack_8h.html#a0b12bda4f5bbbab0cbc1a6cd97ca8e6b">  117</a></span>&#160;<a class="code" href="hsm__context_8h.html#structhsm__context__rec" title="A per state instance context object.">hsm_context_t</a>* <a class="code" href="hsm__context_8c.html#a2d77747e2f011c189e20001f3bbd4a68" title="Advance the iterator to the parent state&#39;s context, return the parent context.">HsmParentContext</a>( <a class="code" href="hsm__stack_8h.html#structhsm__context__iterator__rec" title="Structure to traverse a context stack.">hsm_context_iterator</a> it )</div>
<div class="line"><a name="l00118"></a><span class="lineno">  118</span>&#160;{</div>
<div class="line"><a name="l00119"></a><span class="lineno">  119</span>&#160;    <span class="comment">// pending pointer possess potential parent presence? perhaps.</span></div>
<div class="line"><a name="l00120"></a><span class="lineno">  120</span>&#160;    <span class="keywordflow">if</span> (it-&gt;<a class="code" href="hsm__stack_8h.html#a468c9247400777eda1b6feb5d578a353" title="index of depth into the stack">sparse_index</a>&gt;0){</div>
<div class="line"><a name="l00121"></a><span class="lineno">  121</span>&#160;        <a class="code" href="hsm__types_8h.html#a5041728bd5890050e49ba4506a83f86f" title="32 bit unsigned integer">hsm_uint32</a> bit= (1 &lt;&lt; --it-&gt;<a class="code" href="hsm__stack_8h.html#a468c9247400777eda1b6feb5d578a353" title="index of depth into the stack">sparse_index</a>);</div>
<div class="line"><a name="l00122"></a><span class="lineno">  122</span>&#160;        <span class="keywordflow">if</span> ((it-&gt;<a class="code" href="hsm__stack_8h.html#aeb87bb150bdcab632f4cd300c8dff869" title="pointer the the machine&#39;s stack">stack</a>-&gt;<a class="code" href="hsm__context_8h.html#a1483325021805936ca81887f962c621d" title="bit flags for whether a push added unique data">presence</a> &amp; bit) !=0) {</div>
<div class="line"><a name="l00123"></a><span class="lineno">  123</span>&#160;            it-&gt;<a class="code" href="hsm__stack_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="pointer to the current unique context data">context</a>= it-&gt;<a class="code" href="hsm__stack_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="pointer to the current unique context data">context</a>-&gt;parent;</div>
<div class="line"><a name="l00124"></a><span class="lineno">  124</span>&#160;        }</div>
<div class="line"><a name="l00125"></a><span class="lineno">  125</span>&#160;    }</div>
<div class="line"><a name="l00126"></a><span class="lineno">  126</span>&#160;    <span class="keywordflow">return</span> it-&gt;<a class="code" href="hsm__stack_8h.html#a74b87d8a36ddc6006b1f4511c8b2b48f" title="pointer to the current unique context data">context</a>;</div>
<div class="line"><a name="l00127"></a><span class="lineno">  127</span>&#160;}</div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="dir_6c36b64852547327283732128225c9d7.html">hsm</a></li><li class="navelem"><a class="el" href="hsm__context_8c.html">hsm_context.c</a></li>
    <li class="footer">Generated on Sat Jul 7 2012 22:48:11 for hsm-statechart by
    <a href="http://www.doxygen.org/index.html">
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>
  </ul>
</div>
</body>
</html>
